home *** CD-ROM | disk | FTP | other *** search
/ Directorty Opus 5 - Magellan 2 / Opus 5 - Magellan 2.iso / Extras / DOpus_LogTrim / Lumberjack.txt < prev   
Text File  |  1997-06-02  |  3KB  |  116 lines
  1.  
  2.                               LumberJack v1.0
  3.                                By Adam Dawes
  4.                              25th August 1994
  5.  
  6.  
  7.  
  8. What is Lumberjack?
  9. ===================
  10.  
  11.  
  12. Lumberjack is a small utility that allows you to automatically cut down
  13. your log files. (Yes, I know it's a very bad pun but I liked it. :)
  14.  
  15. It's good to insert in a script file for utilities that generate continuous
  16. log files, so that when they finish working, the beginning of the file is
  17. trimmed.
  18.  
  19. Lumberjack can be told to cut the log file to any size you like, and it
  20. will start to cut at a complete line of text (so if you ask it to keep
  21. 20000 bytes, it may only keep, say, 19987 bytes so as to avoid chopping a
  22. line of text in half).
  23.  
  24. Lumberjack will actually chop /any/ file to a specified length, but I
  25. strongly recommend you only use it on text files!
  26.  
  27.  
  28.  
  29.  
  30. System Requirements.
  31. ====================
  32.  
  33.  
  34. Lumberjack should operate on any Amiga, running any kickstart system.
  35.  
  36. Please contact me if this is not the case and I will attempt to fix it!
  37.  
  38.  
  39.  
  40.  
  41. Usage.
  42. ======
  43.  
  44.  
  45. Lumberjack may only be executed from the command line (or, obviously, from
  46. within a script).
  47.  
  48. The command should be entered as follows:
  49.  
  50.  
  51.     Lumberjack <Inputfile> <Outputfile> [<Outputsize>]
  52.  
  53.  
  54.  <Inputfile> is the filename of the log file to be trimmed
  55.  
  56.  <Outputfile> is the filename to write the trimmed log file to
  57.  
  58.  <Outputsize> is the amount of the source file to keep. The resulting
  59.               output file may not be exactly this size, as that Lumberjack
  60.               ensures that a line of text is not split in half.
  61.  
  62.  
  63. If the outputsize is not specified, a default value of 20000 bytes will be
  64. used. If the outputsize is greater than the size of the entire file, no
  65. data will be lost from the file.
  66.  
  67.  
  68.  
  69.  
  70. Legal stuff.
  71. ============
  72.  
  73.  
  74. The usual stuff applies: I won't be held responsible for any damage done to
  75. your computer system or anyone else's computer system as a result -- direct
  76. or indirect -- of using Lumberjack.
  77.  
  78. If you do experience any problems with this program then please let me know
  79. so that I can attempt to sort it out!
  80.  
  81. Lumberjack may be distributed freely, as long as no unreasonable charge is
  82. imposed for its distribution.
  83.  
  84.  
  85.  
  86.  
  87. Contacting the author.
  88. ======================
  89.  
  90.  
  91. First of all, a plea to anyone who uses this utility: please send me some
  92. mail and tell me what you think! Yes, I know it's 14k and it's written in a
  93. crap language, but it's only an experimental version of the program to see
  94. if anyone actually has any use for it. If it seems you all /do/ find it
  95. useful then I'll rewrite it in assembler and release a new version.
  96.  
  97. I can be contacted at the following addresses:
  98.  
  99.   InterNet:
  100.          Adam@darkside.demon.co.uk
  101.  
  102.   FidoNet:
  103.         Adam Dawes @ 2:254/524.50
  104.  
  105.   Snail Mail (don't expect any fast replies!!):
  106.  
  107.         Adam Dawes
  108.         47 Friar Road
  109.         Brighton
  110.         BN1 6NH
  111.         England
  112.  
  113.  
  114. If you feel like sending cash or presents (who'm I kidding?) then feel free
  115. to send them to the above address. :)
  116.